home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / compress / arj_992a.lzh / UNARJ_PR.TXT < prev    next >
Text File  |  1994-10-05  |  33KB  |  555 lines
  1. M()ir Brandts Honk BBS (p+31-70-3457929 / +31-70-3461215q) is very proud to 
  2. present:
  3.  
  4.         UNARJ-ST 9.92 (rev. I_A/Ni! 2.024: created @ Oct  5 1994 22:38:50)
  5.           compatible with: ARJ 2.41 (c) Copyright 1991-1993 Robert K. Jung
  6.  
  7. Usage:  UNARJ_PR.TTP <command> [{/|-}<switch>[-|+|<option>]...] 
  8.                      <archive_name>[.ARJ] [<base_directory_name>][<wild_name>] 
  9.                      [<path_name>|<wild_name>...]
  10.  
  11. Example UNARJ_PR.TTP commands:
  12.   Extract files from archive:                     e archive
  13.   Extract maintaining directory structure:        x archive
  14.   Extract new and newer files without query:      e archive -u -y
  15.   Extract all files (overwrite; no query!):       x -y archive
  16.   Extract subdirectory from archive:              e archive subdir\*.* -p1
  17.   List files in archive:                          l archive
  18.   Test integrity of files in archive:             t archive
  19.   Extract from a multiple volume archive with
  20.   pause for FIRST archive *and* any subsequently
  21.   loaded volume to enable disk-exchange! ->       x -~k a:\archive
  22.   Show extended help and pause per 10 lines:      -? -jp10
  23.   
  24. Detailed info of all supported options:
  25.  
  26. Command list:
  27.  
  28. <+       >: May only be used in environment variable or configuration file 
  29.             loaded by environment variable. See manual for more info.
  30. <e       >: Extract files from an archive.
  31. <l       >: List contents of archive.
  32. <t       >: Test integrity of an archive.
  33. <v       >: Verbose listing of contents of an archive.
  34. <x       >: Extract files from an archive with full pathname.
  35.  
  36. Option list:
  37.  
  38. <-?      >: Display complete help.
  39. <-#      >: Select files by number. Instead of specifying filenames and dirs 
  40.             you specify their numbers as listed by the 'VIEW' <v> command. 
  41.             Remember that every archive restarts with filenumber 1: this also 
  42.             applies to multiple volumes so take care depacking file-number [1] 
  43.             with those!
  44.             Example:
  45.                 UNARJ_PR.TTP t -# -ay .\ 22-24 5 16-98 35
  46.                                     As you see, ranges can be spacified as 
  47.                                     [number]-[number]. Also you may specify 
  48.                                     overlapping ranges and single-file numbers:
  49.                                     UNARJ_PR.TTP recognizes these overlaps!
  50.             NOTE: INDEED, you see correctly: we have included 'selective 
  51.             file-testing' with this version! (This is ARJ-compatible 
  52.             behaviour...)
  53. <-$      >: Add/Extract volume-label to specified drive.
  54.             Example:
  55.                 -$A:                extracts volume label to drive A:
  56.                 -$                  extracts vol.labels to current drive.
  57. <-&      >: Set critical error handler to use the internal NON-INTERACTIVE 
  58.             variant. This option may be used when using this tool from an 
  59.             'unwatched' batch- or script-file (you don't like to press any key 
  60.             in case of error...) or when you experience problems with 
  61.             redirection on some (older) TOS-versions. <-&-> switches to the 
  62.             interactive variant which is default.
  63. <-+      >: Inhibits ARJ_SW environment variable usage. If specified with a 
  64.             parameter, this parameter is used as the new env.var.name for this 
  65.             session's settings. 
  66.             Example:
  67.                 UNARJ_PR.TTP t -+ARJCFG *.ARJ
  68.                                     will reload the environment from env.var. 
  69.                                     'ARJCFG' after which the commandline will 
  70.                                     be parsed again.
  71.             Precautions against infinite loop have been taken: the user will be
  72.             warned if an infinite loop occurs...
  73.             NOTE: Always put this option first after the hyphen or it might be 
  74.                   recognized as the '+' (ON-code) for any previous option!!!
  75. <-a      >: Allow any file attribute. (Default unless <-~arj> switch ON)
  76. <-a1     >: All file-attribs. are accepted. Empty directories are handled too.
  77. <-b3     >: Do not restore Archive-bits. Files are written with Archive-bit 
  78.             reset.
  79. <-c      >: Skip time-stamp check when updating files.
  80. <-e      >: Exclude paths from filenames. 
  81.             Example:
  82.                 UNARJ_PR.TTP x -e GDA c:\depacked\
  83.                                     extracts all files in GDA.ARJ to 
  84.                                     'c:\depacked\' without adding any 
  85.                                     subdirectories.
  86. <-f      >: Freshen existing files. Only files that exist at the target are 
  87.             done.
  88. <-g      >: Garble with password. 
  89.             Example:
  90.                 UNARJ_PR.TTP a -gcamel XARJ *.C
  91.                                     garbles all *.C files with the password 
  92.                                     'camel'.
  93.             If '?' is specified as password (ARJ-compat. behaviour) or in case 
  94.             NO parameter is specified UNARJ_PR.TTP will ask the user to enter a
  95.             password.
  96.             Important: <-g> can only be disabled by following it with the 
  97.                        <-~ng> option: this is important if you are one of those
  98.                        bonkers that set this flag in their ARJ_SW environment. 
  99.                        <-~ng> is the only way then to switch it off before 
  100.                        weird things start to happen...
  101. <-i      >: Show no progress indicator. (No point/bar/cycler/percentage)
  102.             Default-setting of UNARJ_PR.TTP is to show a progress-indicator 
  103.             (point). Increments are by 64KByte steps...
  104. <-i1     >: Show bar graph progress indicator.
  105. <-i2     >: Show cycler progress indicator. (*)
  106. <-n      >: Do only new files which don't exist at the target.
  107. <-o      >: Do only those files which' time-stamp is ON or AFTER date 
  108.             specified. 
  109.             Example:
  110.                 -o                  today, 0:00 am
  111.                 -oYYMMDD            specified day, 0:00 am: specified time...
  112.                 -oYYMMDDHHMMSS      both date and time specified by user.
  113. <-ob     >: Do only those files which' time-stamp is BEFORE date specified. 
  114.             Example:
  115.                 -ob                 today, 0:00 am
  116.                 -obYYMMDD           specified day, 0:00 am
  117.                 -obYYMMDDHHMMSS     day, time specified.
  118. <-od     >: Do only those files which' time-stamp is NOT OLDER than N days. 
  119.             Example:
  120.                 -od                 today
  121.                 -od25               not older than 25 days.
  122. <-p      >: Match using full pathnames.
  123. <-p1     >: Match path and it's subdirectories.
  124. <-q      >: Query on each file.
  125. <-r      >: Recursive search & match. Search: ARJ-files are searched for in 
  126.             subdirectories too.  Match: all target-files inside subdirectories 
  127.             are matched too. (You might use <-~sr> to enable/disable ARJ-file 
  128.             recursive search.
  129. <-u      >: Update target files. The target file's time-stamp is used unless 
  130.             <-o> flags are specified.
  131. <-v      >: Enable multiple volumes. (Default unless <-~arj> flag switched ON)
  132. <-y      >: Assume YES on all queries except the prompt for 'next volume' when 
  133.             ARJ-files are written to/read from a removable media.
  134. <--      >: Stop parsing of options. (This option might be necessary if 
  135.             filenames or paths are specified which start with '-'.
  136.  
  137. -h Shifted Options list:
  138.  
  139. <-ha     >: Ignore Readonly-attribute of target-file(s). When extracting these 
  140.             files are overwritten.
  141.  
  142. -j Shifted Options list:
  143.  
  144. <-ja1    >: Disable display of archive-banners & file-comments. Use <-~nb> or 
  145.             <-~nc> options if you want to disable only one of the above.
  146. <-jc     >: Exit after a specified filecount. 
  147.             Example:
  148.                 UNARJ_PR.TTP x -jc50 *
  149.                                     stops depacking and exits UNARJ_PR.TTP 
  150.                                     after extracting 50 files successfully.
  151. <-jd     >: Ensure a specified amount of